home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / multi13.lzh / MULTI13.TXT next >
Text File  |  1989-04-06  |  11KB  |  223 lines
  1. MultiArc v1.32
  2.  
  3. MultiArc is Shareware
  4. (c) 1990 Ross Judson
  5.  
  6. Legal Stuff
  7.  
  8.     This program and documentation file may be distributed
  9. freely as long as:
  10. 1)    There is no charge for the distribution.
  11. 2)    This documentation file and the program are not separated.
  12. 3)    The terms of the Shareware agreement (below) are adhered to.
  13.     
  14.     By using this software, you agree that Ross Judson will not
  15. be held liable for any damages resulting from the use or misuse
  16. of the program.
  17.  
  18. Introduction
  19.  
  20.     MultiArc v1.32 is a program that enables the user to
  21. conveniently view and extract the contents of multiple archive
  22. files (which are frequently the result of batch downloads).  It
  23. knows about ARC version 6, LHArc and Zoo.  You provide it with a
  24. list of archive files by one or more of several different
  25. methods. It creates a series of folders (named after each
  26. archive) then extracts the contents of each archive into its own
  27. folder.
  28.  
  29. How to run MultiArc
  30.  
  31.     MultiArc can be accessed in a number of ways.  The simplest
  32. is to double click on its icon from the desktop.  This will run
  33. the program and present the main dialog, which is described
  34. below.
  35.     Another way is to install multiarc.prg to have a document
  36. type.  This is done by clicking on the multiarc program icon and
  37. then choosing Install Application from the Atari desktop menu. 
  38. You can then enter ARC, LZH, or ZOO for the document type.  Now
  39. choose Install.  If you want your changes to be retained, you'll
  40. have to save your desktop.  See your Atari manual for information
  41. on how to do this (essentially, you just choose "Save Desktop"
  42. from the menu).  Unfortunately, with the GEM desktop you can only
  43. have one document type per application, even though MultiArc
  44. knows how to handle three.
  45.     If you have Hotwire!, you can put all three extenders in the
  46. program information box.  See your Hotwire! manual for details on
  47. how to automatically run applications by clicking on documents in
  48. MaxiFile.
  49.     With NeoDesk 2, you can place two of the extenders in the
  50. application installation dialog.  You will probably want to use
  51. ARC and LZH because Zoo files are fairly rare.
  52.     The niftiest solution is afforded by NeoDesk 3.  You can
  53. select a number of archive icons and drag them to the multiarc
  54. icon.  Multiarc will start and all of the selected archives (up
  55. to 20) will be in the program list, ready to be extracted.  A
  56. similar action can be accomplished in NeoDesk 2 by shift-
  57. selecting the archive icons you wish to pass to MultiArc then
  58. shift-double-clicking on the MultiArc program icon.
  59.     If you are working from a command line, you can pass
  60. wildcarded file specifications to the program as arguments.  A
  61. filename passed on the command line doesn't have to have
  62. wildcards.  If it does, MultiArc recognizes two wildcard
  63. characters: the star symbol (*) and the question mark (?).  These
  64. are the standard wildcard characters used by TOS.  The star
  65. symbol replaces any number of different characters until the
  66. extension dot (.) or the end of the file name.  The question mark
  67. replaces exactly one character for the position in which it
  68. appears.  See your atari documentation for more details. 
  69. MultiArc accepts wildcards only in the file name itself, not in
  70. the path.
  71.     When arguments are passed to the program (either via a
  72. command line or NeoDesk 2/3 icon dragging) each argument is
  73. evaluated.  Wildcards can optionally be specified in each
  74. argument.  Wildcarded arguments are expanded into the file name
  75. set they represent.  A test is made to ensure that a recognized
  76. file extension is used and at least one archive file exists in
  77. the set.  There is a limit of 20 on the number of files that can
  78. be listed so only the first 20 valid file names will be used. 
  79. Remember that the command line is limited to 127 characters, so
  80. there will be a practical limit as well on the number of
  81. arguments that can be passed.
  82.  
  83. The Main Dialog
  84.  
  85.     This dialog consists of a number of control buttons and the
  86. file list below them.
  87.     The Extract button breaks up all the archives in the file
  88. list, then exits.
  89.     The Clear button empties the file list of all entries.
  90.     The Help button shows dialogs with some quick help
  91. information and shareware information.
  92.     The Configure button takes you to the Configuration dialog,
  93. described below.
  94.     The Exit button quits the program.
  95.     The A/L/Z, ARC, LHArc and Zoo buttons are quick ways to grab
  96. all the files of the specified type in a directory and place them
  97. in the file list.  You are prompted to find a directory.  Once
  98. you have arrived at the directory you want click on the OK
  99. button.  All the archive files matching the button you clicked on
  100. will be placed in your list (the A/L/Z button matches all three
  101. types).
  102.     You can use the arrow buttons at the right to scroll through
  103. your list of archives.  There is a limit of 100 of the number of
  104. names that may appear in the list.  Double arrows scroll by a
  105. screen full and single arrows scroll by one line.
  106.     In addition, you can click on any entry in the file list. 
  107. If you click on an empty entry, the program will prompt you to
  108. find an archive file to add to the list.  You can specify a
  109. wildcarded file name in the file selector, or simply find the
  110. archive you want to add.  You continue to add archive files until
  111. you click on the cancel button in the file selector.  If, for
  112. example, you wanted to add all the ARC files in directory C:\TMP
  113. that start with "XL", you would first change the directory shown
  114. in the file selector to C:\TMP.  Then enter "XL*.ARC" in the
  115. selection field, and click on OK.  See your Atari manual for more
  116. details on how to use the file selector.  If you have an extended
  117. file selector program such as UIS III or Little Green Selector,
  118. these operations become considerably easier.
  119.     When you tell MultiArc the name of a file to add (by
  120. clicking on a blank entry and selecting something with the file
  121. selector) the name you supply will be checked to ensure it has a
  122. known extension (.ARC, .ZOO and .LZH) and that at least one file
  123. matching the specification exists on the disk.  If you don't give
  124. anything in the selection field, MultiArc will check the
  125. directory you specify and pick up all the archive files of all
  126. three types (similar to the A/L/Z button).
  127.     Don't worry about spaces in the list.  The program will skip
  128. over blanks.
  129.     If you click on an entry with a name, you will be shown the
  130. contents of that archive.  If you hold down the alternate key
  131. while clicking on a file name, that name will be deleted from the
  132. list.
  133.     Whenever you perform an operation that requires MultiArc to
  134. run an archive program it will check to see that it knows where
  135. the archive program is.  If it doesn't, it will ask you to check
  136. your configuration and set the locations properly.
  137.     The deletion boxes in the centre of the file list indicate
  138. to MultiArc whether you want it to delete the archive file after
  139. successfully extracting it.  If errors occurred while extracting,
  140. it will ask you whether you want to continue processing the other
  141. files.  It will not delete the archive.
  142.     The elongated, gray box allows you to toggle all the delete
  143. boxes on or off with one click.
  144.  
  145. The Configuration Dialog
  146.  
  147.     The Configuration dialog allows you to tell MultiArc where
  148. your archiving programs are located. By saving this information
  149. you won't have to enter it each time you run the program.  You
  150. can also tell it a default directory to show you when you click
  151. on an empty file entry in the main menu.  This is very convenient
  152. if you consistently download files to a particular directory.
  153.     You can click on each of the ARC, LHArc and Zoo buttons to
  154. show MultiArc where each of these archive programs resides.
  155.     If you click on Def Dir, MultiArc will ask you to find the
  156. directory you wish to appear as the default when looking for
  157. archives to add.  You do not need to enter anything in the
  158. selection box.  Just find the directory and click on OK.
  159.     If you click on Done, you will be taken back to the main
  160. menu.  The settings you have made will persist for this session
  161. only.
  162.     If you click on Cancel, you will be taken back to th